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INTRODUCTION 


This manual describes Microtec’s 8080/8085 Linking Loader 
that accompanies the 8080/8085 Relocatable Assembler. The 
Linking Loader can be used to combine several independently 
assembled relocatable object modules into a single absolute 
object module. External references between modules are 
resolved with the final absolute symbol value being substituted 
for each reference. 

The Loader not only provides for the linking of several 
modules and adjusting of the relocatable addresses into 
absolute addresses, but allows the program segment addresses 
to be specified, PUBLIC symbols to be defined, final load 
address to be specified and the order of loading of the 
program segments. 
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LOADER OPERATION 


Many programs are too long to assemble as a single 
module. These programs can be subdivided into smaller 
modules and assembled separately to avoid long assembly time 
or to reduce the required symbol table size. After the separate 
program modules are linked and loaded by this program, the 
output module functions as if it had been generated by a single 
ass emb ly . 

The primary functions of the Linking Loader are as 
follows : 

1. Resolve external references between modules 
and check for undefined references (linking) 

2. Adjust all relocatable addresses to the proper 
absolute addresses (loading) 

3. Output final absolute object module 

To understand the loading process and to enable the 
user to use the assembler and Linking Loader (hereafter called 
Loader) effectively, the user should understand the various 
program segments and segment load addresses. Although described 
in the Assembler Manual the various segments are summarized 
below. 

Absolute Segment - this is that part of the assembly 
program that contains no relocatable information but 
is to be loaded at fixed locations in the users memory. 
Absolute code is placed into the output object module 
exactly as it is read in the input modules. 

Code Segment - the code segment contains that part of 
the program which comprises actual machine instructions 
and which typically can be placed into ROM. Instructions 
in the code segment can make reference to any other segments 
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Data Segment - the data segment contains specifications 
for that part of a users program that typically contain 
run time data and which usually resides in RAM. Of course 
this segment could contain actual machine instructions. 

Stack Segment - the stack segment is used as the 8080/8085 
run time stack during program execution. 

Memory Segment - the memory segment is usually the 
high address portion of memory which is not allocated 
to any of the other segments. Data tables may expand 
into the memory segment but the assembler has no facility 
to cause instructions to be loaded into the Memory Segment 
The start of the Memory segment is determined at Load Time 

The Loader allows the user to load the programs segments 
into a contiguous program module or to specify the starting 
address of any or all of the segments. The user may also 
specify the order in memory in which the segments will be 
placed. The default memory organization used by the Loader is 
shown below. 


High 


addresses 


MEMORY 

BASE 


BASE 

STACK 


DATA 

BASE 

CODE 

BASE 
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This is the typical memory organization used in most 
programs. Many users will want to place the STACK segment 
after the CODE segment so that the DATA segment can expand 
into the MEMORY segment during program execution. 

The BASE addresses for all segments is the low address 
of the segment. When a user specifies the starting address 
of a segment via a Loader command, it is the BASE address 
that is being specified. 

Relocation Types 

The relo.cation type of any program segment is determined 
in the assembler by the CSEG and DSEG commands. The effect 
of the three relocation types in the Loader are explained 
below. 

Byte Relocation - this implies that no operand was 
specified on the CSEG or DSEG directives. In this 
case the segment from the object module will be placed 
immediately after the same segment from the preceding 
object module and there will be no wasted memory. 


Page Relocation - this relocation type is specified by 
the PAGE operand on the CSEG or DSEG directive in the 
Assembler. It implies that the program segment must 
beg;in on a page boundary (i.e. 0, lOOH, 200H, ...). 

This code is placed by the Loader at the next available 
page boundary after the same segment type from the 
preceding object module. 
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Inpage Relocation - this is specified by the INPAGE operand 
on the CSEG or DSEG directive. It implies that the program 
segment must not cross a page boundary. If the loader 
determines that a program segment cannot fit within the 
current page it begins the segment on the next page boundary 
as though it was PAGE relocatable. 

In the typical load sequence the Loader places all COPE 
segments contiquously in memory followed immediately by all 
DATA segments with no extra bytes between the segments. However, 
if any of the DATA segments specify PAGE or INPAGE relocation 
then the Loader must start the DATA segement at a page boundary 
so that relocation will be preserved. To avoid any wasted 
memory the user can always specify starting addresses. In the 
above case the same problem exists if the DATA segment is 
followed by the CODE segment and the CODE segment has specified 
any PAGE or INPAGE relocation. 

When initially developing and debugging a program it is 
helpful to specify each segment in each assembly as PAGE 
relocatable. This will then force the starting address of 
each module to end in OOH and will make it easier for the 
user to follow the flow of the program since the assembler 
output listing contains the correct memory addresses except 
for an offset that must be added to the high order address byte. 
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LOADER COMMANDS 


The Loader reads a series of Commands from the Command 
input device. The Commands may be read in an interactive or 
batch mode (see Loader Installation Notes). The last command 
must be an EXIT or an END command. 

The object modules are read from the object module input 
device or files specified on LOAD command. The object modules 
may be read from the same input device as the Commands. 

The output of the Loader consists of an absolute load 
module suitable for loading into an actual microcomputer. 

The output module is written to the object module output 
device and is described in the Loader Installation Notes. 


All commands begin in column 1. Command arguments may 
begin in any column and must be separated from the command 
by at least one blank. Comments may be placed in the command, 
and are indicated by an asterisk in column 1. 


The following pages describe the Loader commands. In the 
command descriptions brackets, { }, are used to indicate 

optional arguments. A summary of the commands is given below. 


CODE 

DATA 

STACK 

MEMORY 

ORDER 

START 

STKLN 

NAME 


Set Code Segment Base Address 
Set Data Segment Base Address 
Set Stack Segment starting Address 
Set Memory Segment Base Address 
Specify Segment Order 

Specify Starting Output Module Address 
Specify Stack Length 
Specify Output Module Name 
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LOAD 

'Load specified 

Object Modules 

PUBLIC 

Specify PUBLIC 

symbols 

LIST 

List specified 

elements 

NLIST 

Do not list specified elements 

EXIT 

Exit Loader 


END 

End command stream and finish final load 

* 

Comment 



Command arguments that ar e nume r ic may be either decimal 
or hexadecimal. Hexadecimal constants are terminated by a 
H, e.g. IFH, and need not have a leading zero if it starts 
with A-F, 

Commands may be read in any order and the same command 
may be used more than once. The last use of a command determines 
and command parameters. Commands may be placed before or after 
the LOAD command except for the CODE , DATA , STACK , and MEMORY commands, 
which if specified must precede the first LOAD command. 


3-2 



CODE 


Set Code Segment Base Address 


The CODE command is used to specify the starting address 
of the Code Relocatable Segment. If not specified, the 
starting address is zero or begins after the preceding segment 
if this is not the first segment in memory. 

Example: 

CODE 400H 



CODE value 


where : 

value - specifies the starting address of the CODE segment 
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DATA 


Set Data Segment Base Address 


The DATA command is used to specify the starting address 
of the Data Relocation Segment. If not specified the starting 
address follows the CODE segment or is zero if the DATA segment 
is the first segment in memory. 

Example: 

DATA lOOOH 


^ DATA 


value 


where: 

value - specifies the starting address of the DATA segment. 
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STACK 


Set Stack Segment starting Address 


This command is used to specify teh starting address 
of the STACK segment. The length of the STACK segment is 
specified by the STKLN command or is contained in the Load 
Module, If the Stack address if not specified it will start 
immediately following the preceding segment in memory or 
begin at zero if this is the first segment. 

Example : 

STACK 3FFH 


r 


STACK 


value 


wh ere: 

value - specifies the starting address of the STACK segment. 
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MEMORY — Set Memory Segment Base Address 

The MEMORY command is used to specify the starting address 
of the MEMORY segment. The length of the MEMORY segment will 
be specified as zero on the load map but it is actually the 
length of available memory remaining in a user system after 
the other segments have been loaded. If not specified the 
starting address will start immediately following the preceding 
segment in memory or begin at zero if this is the first segment. 

Example: 

MEMORY 8000H 



where: 

value - specifies the starting address of the MEMORY segment. 
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ORDER 


Specify Segment Order 


As described under Loader Operation the normal order of 
the segments in memory is: CODE, DATA, STACK , MEMORY . The ORDER 
command is provided for users who do not need to specify 
starting addresses for each segment but would like to segments 
to be placed in memory in a different order. If the user 
specifies starting addresses for the segments the order of the 
segments is of no particular importance. 

The user specifies the order of the segments separated 
by commas. All segments must be specified in the command 
or an error message is printed. 


Examp 1 e : 


ORDER C,S,D,M would place segments 

in the order CODE, STACK, 
DATA and MEMORY 


^ ORDER seg,seg,seg,seg 


whe r e : 

seg - specifies one of the four segment types as follows: 

C - CODE 
D - DATA 
S - STACK 
M - MEMORY 

all four segment types must be included in the command. 
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START — Specify Starting Output Module Address 

This command is used to specify the starting address to 
be placed in the terminator record of the object module. If not 
specified the’ starting address is obtained from the END record 
of the main program of the input modules. If no main program 
has been read the starting address will be zero. 

Exarapl e : 

START 8 



where : 

value - specifies the starting address to be used in 
the object module. 
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STKLN — Specify Stack Length 

The STKLN command is used to specify the length of the 
STACK segment of the Loader. If not specified the stack length 
is determined by the sum of the stack segment lengths specified 
in the load modules. 

Example : 

STKLN 20H 



where: 

value “ specifies the length of the STACK segment 
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NAME — Specify Output Module Name 

The NAME command is used to specify the name of the 
final output object module. Currently this command performs 
no function for the output module as the module is in Intel’s 
hexadecimal format and contains no name. It will be used 
when the output object module is in relocatable format. The 
user specified name may be any standard symbol and be up to 
6 characters. If the user does not specify a name, the name 
of the output module will be taken from the first input module. 

Examp 1 e : 

NAME READER 



where: 

name - is a symbol that specifies the object module name 
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LOAD — Load specified Object Modules 

The LOAD command is used to specify one or more input 
object modules to be loaded. If the command operand is a 
number, it is assumed that the input module is to be read from 
that logical device. If the command operand is not a number, 
it is assumed the name of a disk file is being specified, and 
the object module will be read from the file. Object modules 
may be read from a combination of peripheral devices and disk 
files. A user may use as many LOAD commands as needed. 


The object modules are loaded in the order specified, 
with each module being loaded into memory immediately behind 
the preceding mo d u 1 e . 


Example ; 


LOAD 7,FILE1,FILE2,7 Four modules are to 

to loaded, the first 
form unit 7, FILEl and 
FILE2 from disk and 
the fourth from unit 7 
• Unit 7 may be a paper 
tape reader for exampl 


^ LOAD module^ { jmodule^, . . . , module^ } 

where: 

module^ - specifies the number of a logical input device 
or the name of a disk file on which the object 
module resides. Operands are separated by 
commas. 
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PUBLIC 


Specify PUBLIC" Symbols 


This command is used to define and/or change the value of 
a PUBLIC symbol. If the symbol specified by this command is 
already a PUBLIC symbol (from an object module), the value of 
the symbol is changed to that specified by the user. If the 
symbol sepcified by this command is not already defined, it will 
be entered in the Loader Public symbol table along with the 
specified value and will then be available to satisfy external 
references from object modules. 

This command is useful in that it allows the user to 
specify the value of some external symbols at Load time and 
possibly avoid any reassembly. To change the value of a 
symbol that is Public in a object module this command must 
be specified after the object module has been loaded via the 
LOAD command. 

Example; 

PUBLIC INPUT=2FH,OUTPUT=200H 

\ 

^ PUBLIC sym^=val^{ ,sym 2 =val 2 » . . . , sym^=val^ } 

where: 

sym^ - is user defined PUBLIC symbol 
val^ - is the value of the symbol 
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LIST — List Specified Elements 

The LIST command may be used to generate listings of the 
elements specified. The defaults are: no symbol tables are 
listed, an output object module is produced, no symbols are 
placed in the output object module, and local symbols are not 
purged from the input modules. 

Example : 

LIST T 


LIST 0 ,P, S,T 

where : 

0 - specifies that an object module is to be produced, 
(default) 

P - specifies that any symbols present in the input 

modules be placed into the Loader symbol table, (default) 

S - specifies that the local symbol table be written to 

the object module and thus may be used for debugging. 

. T - specifies that both PUBLIC and local symbol tables be 
listed on the list output device. 


list symbol tables on 
list device 
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NL I S T — Suppress Listing of the Elements Specified 

The NLIST command is the opposite of the LIST command 
and is used to suppress the listing of the elements specified. 
The elements may be turned back on with the LIST command. 


Example ; 


NLIST 0 don’t produce an object 

mod ul e 


NLIST 0,P,S,T 


where: 

0 specifies that no output module is to be produced. 

This is useful to check for errors. 

P - specifies that any symbol tables present in the input 
modules not be placed in the Loader symbol table. 

This is useful if many modules are being loaded and 
the symbol table may become full. Of course these 
local symbols may then not be listed in a symbol table. 

S - specifies that the local symbol table not be written 
to the object module and thus may not be used for 
debugging . 

T - specifies that no symbol tables be listed on the 
output list device. 
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EXIT 


Exit Loader 


The EXIT command is used in the interactive mode to 
exit the Loader. This command is useful when the user finds 
an error that will require the exiting of the Loader to fix. 

It acts like an END command except the final load does not take 
place and an output object module is not produced. This command 
may also be used in the batch mode by making it the last command 
in the command stream. In this case the final load will not 
take place but the object modules and commands will be read 
and checked for errors. 


EXIT 



END 


End command stream and finish final load 


The END command should be the last command in every 
Command stream except if the EXIT command is used as described 
under that command. It initiates the final steps in linking 
and loading the input modules. An exit is then made from the 
program. 



Comment — Specify Loader Comment 

An asterisk may be used to specify a comment in the command 
input stream. The asterisk should be in column one. 


Example : 
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HOW TO USE THE LOADER 


The Loader 

The Loader program is usually supplied as an unlabeled 
unblocked magnetic tape with 80 character card image records. 
Other media may be requested. 

The Loader is written entirely in Fortran and is comprised 
of a main program and several subroutines. The main program 
appears first on the tape and the last subroutine is followed 
by a tape mark. The Loader is located after the assembler on 
t he t ap e . 

The Loader Installation Notes describe program installation 
and any modification that may have to take place for a particular 
computer. It is helpful to read these notes before installing 
the program. 

Loader Execution 

This is a two pass loader in which the commands and 
object modules are checked for errors during the first pass 
and a symbol table of PUBLIC symbols is formed. Errors detected 
during this phase of the program will be displayed on the listing 
If the user is in batch mode any errors found during this pass 
will cause the loader to terminate with the message "LOAD NOT 
COMPLETED". If the user is in interactive mode, only those 
errors found in the object modules will caqse termination of 
the loader . 

During pass two of the Loader, the. final object module is 
produced and any undefined externals are printed on the list 
device. A symbol table may also be listed. 
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When executing the Loader, the user should place the 
Loader Commands on the command Input device expected by the 
program. Of particular importance is that the user specify 
the correct number of modules to be loaded and where they 
are loaded from on the LOAD command. 

Loader Listing 

The following pages show a sample listing from the 
Loader which is used to describe both the output listing 
and the Loading process. 

The first page of the output listing lists all commands 
entered by the user along with any command errors. Following 
this would be any load module errors that occurred in the modules 
loaded via the LOAD command. If no fatal errors occur up to 
this point then a load map is displayed which lists the names 
of all input modules followed by the starting addresses of the 
CODE and DATA segments for that module. The ending address+1 
for each segment is displayed at the end of all modules and is 
indicated by the //. Following this, the starting and ending 
addresses of the STACK and MEMORY segments are displayed. The 
ending addresses plus one are once again shown by the double 
slashs, //. When the starting and final addresses are the same, 
it implies that the length of the segment is zero. 

Following the Load Map is a list of all PUBLIC symbols 
as well as local symbols if the user specified the "LIST T" 
command. PUBLIC symbols are those declared public in the 
assembler by the PUBLIC directive. Local symbols are those 
that were output by the assembler if the user had specified 
the "LIST B" directive. These may be used for debugging. 
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As shown on the example listing, the only other information 
that will be displayed on the listing after this point are any 
undefined externals found during final load. 

The end of the Load program is indicated by the "LOAD COMPLETE" 
or "LOAD NOT COMPLETE" message. 
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♦♦LOADER COMMANDS 


♦ 

« 

LIST T, S 
DATA A07H 
CODE 605H 
ORDER C, S. D. M 
STACK AOOH 
BTKLN 12 
LOAD 5, 5 
LOAD 3 
END 


♦♦LOAD MAP^^ 


MODULE 

CODE 

DATA 

MAIN 

0605 

0407 

READ 

063F 

0458 

MODULE 

06*73 

0500 

// 

06A4 

050F 

STACK 

09F4 


// 

OAOO 


MEMORY 

050F 


// 

050F 


♦♦PUBLIC 

SYMBOLS 



TIN 

061C 

CRLF 

0634 

TOUT 

0629 

ECHO 

0457 

INBUF 

0407 

IBUFEN 

0457 

READ 

063F 




♦♦LOCAL SYMBOLS 







BSPA 

OOOB 

BLNK 

0020 

ASCR 

OOOD 

TAB 

OOOB 

READ 

063F 

READIO 

0644 

READ20 

0652 

READ30 

065F 

READ40 0669 
READ80 0606 

♦♦MODULE MAIN 

READ50 

0673 

READ60 

067D 

READ70 

0680 


UNDEFINED EXTERNALS 
0011 

♦♦LOAD COMPLETED 



BSPA 

.OOSH 

BLNK 

00020H 

ASCR 

OOOODH 

TAB 

OOOOBH 

READ 

0063FH 

READIO 

00644H 

READ20 

O0652H 

READ30 

0065FH 

READ40 

00669H 

READ50 

006 73H 

READ60 

0067DH 

READ70 

00680H 


READBO 006B6H 

: 1 E0605003 1 000ACD3F062 1 07047EFE2023C A0E06CD000023C30506DB00E602C A 1 C0654 
: 1E062300DBOOE67F47C9DBOOE601CA290678D300C9060DCD2906060ACD2906C92107BE 
: 1E064 10004 1EO0CD1C06FE18C25206CD34O6C33FO6FEODC25FO67BB7CA44O6360DC9C7 
: 1E065F00FE7FC273067BB7CA44062B1D0608CD2906C38006FE0BCA7D06FE20DA800613 
: 1E067D0077231C7BFE57CA69063A5704B7CA4406CD2906C34406002100003AOB05B715 
; 09069B00C2A006002F210E057615 
: OF050000C3A0060 1 OB0580A0060B000506A00096 
: 0006050 1F4 


LOADER EXAMPLE OUTPUT OBJECT MODULE 



THE TERHINAL 


56 

5T 

59 

59 

60 
61 
62 

63 

64 

65 

66 
bT 


: ENTRY PARAMETERS 

t 8 - CHARACTER T3 OUTPUT 

t EXIT PARAMETERS 
t NONE 

: REGISTERS USED 
: A,B 


68 

0024 

OB 

00 



OUTBt 

IN 

USTAT 

;reao status 

69 

0026 

E6 

01 




ANI 

troy 

:CHECK IF REAOY 

TO 

0028 

CA 

24 

00 

c 


JZ 

OUTS 

;N0T REAOY 

T1 

002B 

78 





HOY 

A,B 


T2 

002C 

03 

00 




3UT 

UOAT3UT 

JOUTPUr DATA 

T3 

002E 

C9 





RET 



74 






t 




75 






: NAME • 

CRLF 



76 






• 

9 




77 






X THIS ROUTINE 

OUTPUTS A CARRIAGE 

RETURN 

78 






; AND LINE FEEO 



79 






• 

9 




80 

002F 

06 

00 



CRLFI 

MYI 

BtASCR 


81 

0031 

CO 

24 

00 

c 


CALL 

ours 


82 

0034 

06 

OA 




MYI 

B.ASLF 


83 

0036 

CO 

24 

00 

c 


CALL 

OUT8 


84 

0039 

C9 





RET 



85 






9 

9 




86 







3SEG 


rSET DATA SEGMENT 

87 

0000 





INBUFI 

OS 

80 

UNPUT BUFFER 

88 






IBUFENOI 



UNO OF BUFFER 

89 

0050 





ECHOt 

OS 

1 

;ECH0 FLAG 

90 

0000 





USTAT 

EQU 

0 

TUSART STATUS 

91 

0000 





UOATOUT 

EQU 

0 

TUSART OUTPUT 

92 

0000 





uoatin 

EQU 

0 

:USART INPUT 

93 

0001 





TROY 

EQU 

1 

; TRANSMIT REAOY 

94 

0002 





RROY 

EQU 

2 

;reaoer ready 

95 

0000 





ASCR 

EQU 

13 


96 

OOOA 





ASLF 

EQU 

10 


97 

0020 





3LNK 

EQU 

20H 


98 

0017 




c 

TIN 

EQU 

IN8 


99 

0024 




c 

TOUT 

EQU 

OUTS 


100 

0051 






END 

MAIN 



ASSEMBLER ERRORS * 


0 



nmt 

f»U3LIS 

EXTRN 


nn i n 

lN8Ur,t3JF£NO*TIN«TOJT,CRLFt£CHO 

REftO.SCA*! 


THIS IS A SAMPLE PROGRAM THAT SHOWS MOST OF THE REL0CATA6LE 
FEATURES OF THE ASSEMBLER. TWO MODULES ARE LINKED TOGETHER 
TO FORM THE FINAL PROGRAM. PUBLICS AND EXTRNALS ARE USED 
TO PERFORM THE LINK. 

BELOW IS THE MAIN PROGRAM ARD THE f<^0 DRIVERS. THIS IS 
LINKED TO A ROUTINE WHICH READS A LINE OF CODE AND WHICH 
ITSELF REQUIRES THE I/O DRIVERS. 


ISET CODE SEGMENT 


19 

0000 

31 

00 

00 

s 

MAINI 

LXI 

SPtSTACK 

ISET STACK POINTER 

20 

0003 

CO 

00 

00 

E 


CALL 

READ 

;read next line 

21 

0006 

21 

00 

00 

D 


LXI 

H,IN3UF 

?START OF buffer 

22 

0009 

7E 




MAINlOl 

MOV 

A.M 


23 

OOOA 

FE 

20 




CPI 

BLNK 

;CHECK FOR NON BLANK 

26 

OOOC 

23 





INX 

H 


25 

OOOO 

CA 

09 

00 

C 


JZ 

MAINIO 


26 

0010 

CO 

00 

00 

E 


CALL 

SCAN 

IGET VALUE 

27 

0013 

23 





INX 

H 


28 

0016 

C3 

00 

00 

C 


JMP 

MAIN 



30 

31 
3? 

33 

3H 

39 

36 

37 
3S 
39 
%Q 
%l 
h2 
t»3 
kh 

k9 0017 

66 0019 

67 OOIB 

60 OOIE 
69 0020 

50 0022 

51 0023 


OB 00 
E6 02 
CA 17 00 
OB 00 
E6 7F 
67 
C9 


NAME - INS 

THIS ROUTINE MILL INPUT A CHARACTER FROM THE TERMINAL 

ENTRY »ARAHETERS 
NONE 

EXIT PARAMETERS 

A - INPUT CHARACTER 

B * SAME AS A 

REGISTERS USED 
A.B 


IN 

USTAT 

:READ UART STATUS 

ANI 

RROY 

ICHECK IF READY 

JZ 

INS 

;N0T ready YET 

IN 

UOATIN 

IREAO DATA 

ANI 

127 

:OELETE "ARITY BIT 

MOV 

Bf A 


RET 




NAME - 0UT8 



16?EOOOZ500006ECHO«*00000006INBJF*0050000SIBUFENOOEB 

061(i00OlO0 00 310000CO00 00Er 

2%0A0003030i00C3 

200c000300000%00c0 

06%000O106O02100007EFE2023CA0900C0000Q23C3Q0Q0OBQ0E6fl?C&lF00OB00E62F69 

221000030EOQ19001COOOC 

2%OA0002030FOOC6 

280C0003010011009F 

063e000122Q0 97C90BOOE601CA2%OOM030QC90&OD:32iiQ0060AC02(iQOC9FO 

2210000329003200370039 

090AOOQ1010000FO 

0E0200F0 


MAIN OBJECT MODULE 



z 

3 

b 

6 

7 

6 

9 

10 

11 

12 

13 

1^ 

15 

16 

17 

18 

19 

20 
21 
22 
23 
26 

25 

26 

27 

28 

29 

30 

31 


CSFG 

LIST 

LIST 

PUBLIC 

EXTRN 

NAPE - READ 


ISET CODE SFGNFNT 
t 
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CR - END OF CURRENT LINE 

CONTROL X - delete CURRENT LINE 

DEL - OELTE character 

ALL DISPLAYABLE CHARACTERS BETWEEN BLANK AND Z AND 
THE ABOVE SPECIAL CHARACTERS ARE RECOGNIZED BY THER 
ROUTINE AS WELL A$ THE TaE. ALL OTHER CHARACTERS AR F 
IGNORED. an attempt TO INPUT MORE CHARACTERS THEN IS 
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•♦LOADER COMMANDS 


* 

LIST T.S 
DATA A07H 
CODE 605H 
STRT lOOOH 

INVALID COMMAND 
ORDER C. S. D. M 
STACK AOOH 
STKLN 12 
LOAD 5. 5 


••MODULE MAIN 

RECORD OUT OF SEQUENCE 
RECORD 5 - 240A0003030100CB 


••MODULE 

HEADER RECORD ERROR 

record 1 - 1B3E0006CRLF^*0006TIN***0006TOUT**0006ECHO^*0006INDUF*0006IDUFEN005B 
LOAD 5 
END 


♦•LOAD NOT COMPLETED 



Loader Example 

The preceding pages show three assembly listing of programs 
that will be combined by the Loader along with the output of the 
Loader. The main program contains references to a subroutine 
READ and SCAN which are not in the program but are declared 
external and will be found in another object module. The 
second assembly listing shows the READ routine which is required 
by the Main program and also shows that the READ routine requires 
I/O drivers. TIN and TOUT which are declared external and will 
be found in the main program. The third program contains no 
links to the other programs but will also be loaded into the 
final module. 

The Command stream shows that the user has specified 
the starting addresses of both the CODE and DATA segments and 
has changed the order of the segments to CODE , STACK , DATA , and 
MEMORY. The LIST command is then used to obtain a symbol 
table of all PUBLIC symbols used in the modules along with their 
final absolute addresses. Finally the LOAD command is used 
to read the three modules from the device shown. 

The load map shown the starting and ending addresses of the 
three modules in the order loaded. Note that the third module 
had specified a "DSEG PAGE'* direcitve in the assembly listing 
and the load map shows that the data segment for this module 
indeed starts on the next page boundary. 

An undefined external is listed for the Main module and 
its address is specified. From the original listing it can 
be seen that the SCAN routine is not in any module. The user 
could have specified the address of the routine with a PUBLIC 
command. 
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Finally the symbol table of all PUBLIC symbols used in the 
program along with their absolute addresses is shown. The 
user can determine from the addresses as well as the final 
object module displayed on a subsequent page that the modules 
have indeed been linked together to form a final absolute 
module with all addresses adjusted to the correct values and 
any links between modules resolved. 

Following the above example, a Loader run is displayed 
that contains many errors. Most of the load errors shown 
will not occur except under unusual conditions and they 
have been shown for information purposes only. 

The final absolute object module from the example is 
also shown with the local symbols being part of the module. 
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APPENDIX A 


LOADER MESSAGES 


Messages from the Loader may be classified into Command 
Error Messages and Load Messages. Command errors are due to 
invalid commands or command parameters and always cause termination 
of the Loading process in the batch mode. Command messages are 
listed beneath the actual command. Load messages occur during 
the loading of object modules initiated by the LOAD command. 

These messages may be fatal or informative. For most load 
messages, the message is listed followed by the record number 
in the input module and the actual record in error. The module 
name is also listed at the start of the messages for a particular 
module . 

Most load errors should not occur and if they do, the 
user is advised to first reassemble the program and attempt to 
reload . 

Command Messages 

Invalid Command - a command specified by the user is not a 
legal Loader command. 

Invalid Operand - an operand specified for a command contains 
invalid characters, does not exist, or is too large. 

Command Not Allowed - this command is not allowed at this point 
in the program. Due to specifying a load address after a 
LOAD command has been specified. 

Symbol Table Full - user specified a PUBLIC command and no more 
room exists in the symbol table. 

Module Greater than 64K - At final load time the lengths of all 
program segments is greater then 64K memory size. 
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File Note Found - a file specified in the LOAD command does not 
exist or possible an invalid LOAD command operand. 

Invalid Symbol -- a PUBLIC command is specified that contains an 
invalid symbol 


Load Messages 

Invalid Hex Character - a character in the record shown contains 
an invalid hexadecimal character. Some records contains 
symbols as well as hexadecimal numbers. This message does 
not apply to those symbols in the record. 

Invalid Checksum - the record has a checksum error and probably 
contains some changed characters. 

Header Record Error - a header record was not the first record 
in the object module or a header record was found after 
the first record. 

Record too large - a record specifies a record length that is 
greater than 72 characters. 

Invalid Record Type - a record specifies a record type that does 
not exist in the Loader. 

Invalid ID or type - some internal parameters on this record are 
invalid. 

Address out of range - a relocation record specifies relocation 
at an address outside the range of relocation specified 
on the header record. 

External Index out of Range - an External Reference is made to 
an external symbol that does not exist. 

External Table Full - Current object module specifies more external 
symbols then may be contained in external table. Increase 
size of table. 
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Record Out of Sequence - a object module record was read that 
is out of sequence in the module or the user may have 
inadvertently mixed the records if they exist on cards. 

Symbol Table Full - a PUBLIC object module record is being 
processed and the symbol table is full. 

Undefined External - a reference is made to an external symbol 

that has not been defined in another module or by the user. 
The address of the external reference in the original module 
is listed. 

Duplicate Public Name - a PUBLIC symbol is defined that has 
already been defined in another module. Loading will 
continue-and the PUBLIC name will be listed. 

Module Greater than 64K - during initial loading the sum of 
all segment lengths exceeds the 64K memory size. 

Segment Overlap - due to user specified addresses one or more 
of the segments overlap. This is an informative message 
and loading continues. 
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LOADER INSTALLATION NOTES 


These notes are desinged to help the user install the Loader 
and perform and modifications needed for a particular computer. The 
notes are separated into six sections: Program Installation, Program 
Modifications, Batch/Interactive Mode, Program Input /Output , Memory 
Requirements and Overlays, and NOVA Modifications. 

A. Program Installation 

1. The Loader should be compiled once and its object module 
stored on some secondary storage devie (disk) . Compile the 
program in the usual manner, assigning it a name which can be 
refered to by an Execute or Run Statement. If upon loading the 
compiled program, it is discovered that not enough main memory 
is available to hold the entire program, refer to the section 
describing overlay structures. 

B. Program Modifications 

1. The variable IBIT corresponds to the number of bits per word 
in the host computer. IBIT is initially set to 16. This variable 
determines how many characters are packed into one host computer 
word for labels stored in the Loader symbol tables. The user 

may want to increase this variable if his machine has a longer 
word length. Increasing IBIT will allow a larger number of symbols 
to be stored in a fixed amount of memory. When initially installing 
the program, it is suggested that IBIT be left at 16 until the 
program is known to be operating correctly. 

2. To increase the size of the symbol table and thus the number 
and length of the symbols the symbol table can hold, the user 
must change certain variables. The variables that must be changed 
depend on the number of bits per host computer word (see 2), the 
number of symbols in the symbol table, and the number of characters 
used to define a symbol. The variables that define these parameters 



are described below. 


IBIT “ number of bits per host computer word (set by user) 

MLAB -- maximum label length in characters (set by user) 

ICCNT - number of characters per host computer word (calculated) 
IWORD “ number of computer words per symbol (calculated) 

LTAB - length of symbol table (set by user) 

The user must change the following variables to reflect the size 
of the symbol table and the length of a symbol. The length of a 
symbol should correspond to the length set in the Assembler. The 
arrays to change are in COMMON, and therefore, the dimensions need 
to be changed in every subroutine. 

IT AB( IWORD, LTAB) where: IWORD = 1+(MLAB-1) /ICCNT 

ITABV(LTAB) ICCNT = IBIT/8 

ITABS(LTAB) 

NAME (IWORD) 

C. Batch/ Interactive Mode 

1. The program is delivered with the Batch/Interactive flag, IBAT 
set to batch operation. In the Batch mode, commands are echoed 
to the listing device and all command errors are fatal, the final 
load does not occur. In the Interactive mode, commands are not 
echoed to the listing device, and some errors become non-fatal. 

The only fatal command errors are those that may cause some 
object modules to be loaded before an error is found on the LOAD 
command line. 

D. Program Input/Output 

1. The logical I/O device assignments assumed in the Loader 
Program are: 

IPCH = 4 (object module output device, typically punch device) 
ICRD = 5 (command input device, typically card reader) 

IPRT = 6 (listing device, typically printer) 

(intermediate file, disk) 


IMFLE = 7 



IFIL 


= 18 (input object module disk file number; when an 
input object module is on a file, the file name 
is equated to IFIL) 

IRDR = (set dynamically during program execution to the 

input device specified by the LOAD command) 

These device assignments may have to be changed for your system. 

This may be done either in the Job Control Stream or in the 
Program itself. If the assignments are to be changed in the 
program, the variables may be found in Subroutine INIT. 

Note the the intermedate file may be any sequential device such 
as a tape unit. If this is the case a REWIND IMFLE statement 
should be placed in the program. This statement is shown in 
the program near the bottom of the Main Program with a comment. 

2. Reading and writing to a bulk storage device such as a disk 
is not standard in Fortran. See The Assembler Operation Notes 
for a discussion of the various methods. 

3. All Program I/O activity except for generation of the output 
listing is handled in Subroutine INOUT. This includes the reads 
and writes for the intermediate file, reading the command input, 
reading the object module input, and writing the output object 
module. 

4. Three are alternative ways of passing relocatable object modules 
from the Assembler to the Loader (see discussion in Assembler Notes). 
The Input devices or files that hold the object modules to be loaded 
by the Loader are specified as LOAD command arguments. When a . 
disk file is specified as an argument, Subroutine EQUAT is used 

to equate the disk file name to the logical device, IFIL, so that 
the file may be read by the input statements in INOUT. There 
are two basic sections to the EQUAT subroutine. First, the file 
name is packed into a contiguous Hollerith string. The code 



used to pack the characters of the file name into a string will 
work on any two’s complement machine. For a one's complement 
machine, one line or code must be changed. The required change 
is marked with comments in subroutine EQUAT. Two variables 
in subroutine INIT must be set to the correct values for EQUAT 
to work properly. These are as follows: 

ISBIT - actual number of bits in computer word. This may 
or may not be the same as IBIT. 

ICHBT - number of bits per host computer character 

The place to change these in INIT are marked with comments. 

The second part of subroutine EQUAT consists of the code 
required to open the named disk file and equate it to the 
logical device number, IFIL. This code usually consists of one 
statement. The CALL ASSIGN statement that currently exists in 
the program is for a PDP-11. As mentioned in the Assembler Notes, 
some computers can read disk files without any special code to 
open the file. In this case Subroutine EQUAT may not be needed. 

The user will have to check the computer manuals to find out what 
the required statements are to perform the above functions. 

5. Refer to the section on Input/Output in the Assembler Operation 
Notes, as many of the things discussed apply to the Loader. 

6. The I/O statements needed to read in an object module may 
be different depending upon if the module is read from an 
I/O device or a file. The statements in subroutine INOUT at 
line number 200 have two I/O read statements, one for reading 
from a file and one from a device. For most machines these 
statements will be the same as shown. Some users may have to 
change one or the other. Comments in INOUT describe any 
changes necessary. 



E. Memory Requirements and Overlays 

1. The Loader program is smaller than the Assembler program. 
Overlaying should not be necessary. However, for users who may 
want to form their own Overlays or to Segment their programs, 
the following list shows each routine in the Loader and all the 
routines that call it. 


MAIN 

- 


INIT 

- 

MAIN 

INOUT 

- 

MAIN, OBJ, OUT 

OBJ 

- 

MAIN 

LABEL 

- 

MAIN, OBJ 

SYMBL 

-- 

MAIN, OBJ, LABEL 

SCAN 

- 

MAIN 

NAMES 

- 

NAMES, OUT, MAIN 

COMIN 

- 

MAIN 

OUT 

- 

OBJ 

HEXIN 

- 

OBJ 

VHEX 

- 

OUT 

AHEX 

- 

MAIN, NAMES, ERROR 

EQUAT 

- 

MAIN 

ERROR 

- 

MAIN, OBJ 



NOVA Modifications 


When installing the Loader on a NOVA Computer, it is suggested 
the Fortran V be used. If Fortran IV is used, some additional 
program modifications have to be made. 

1. Most versions of NOVA Fortran fill an H DATA specifications 
statement with zeros and not blanks, as is typically done. 
Therefore, characters read in under A formats must have the 
padded blanks stripped off. Insert the following statements 
after Fortran Statement 100 in INOUT. 

DO 105 1=1,80 
IN(I) = IN (I). AND. -256 
105 CONTINUE 

2. All variables initialized in DATA statements must be placed 
in Labeled Common. The variables are local to each Subroutine, 
so unique dummy labels may be used for the COMMON Block names. 

3. The DEFINE FILE statement in the Main program must be 
replaced with a CALL OPEN statement similar to the one shown 
below. 

CALL OPEN (7,"IDUMr*,3,IER) 

4. Binary READ and WRITE statements should be used for the 
intermediate file. To implement this change the Fortran source 
code in INOUT should be as follows: 

300 READ BINARY (IMFLE) 


400 WRITE BINARY (IMFLE) 



A simplified EQUAT Subroutine for PDP~11 computers is shown below. 
This Subroutine may be used to replace the EQUAT Subroutine currently 
In the Loader. 


LOGICAL*! JNAME(18) 


REAL leave REAL, INTEGER; and COMMON 

INTEGER statements In old Subroutine EQUAT 

COMMON in new Subroutine EQUAT 


lERR « 1 
K •* 1 

100 IF((INC(JCOL).EQ.IBLNK .OR. (INC(JCOL) .EQ. ICOMM)) GO TO 200 
IF(INC(JCOL).EQ. ICTAB) GO TO 200 
IFOC .GT. 18) GO TO 900 
JNAME(K) = INC(JCOL) 

IPBUF(K) = INC(JCOL) 

K «= K+1 
JCOL «= JCOL+1 
GO TO 100 

200 JNAME(K) = IBLNK 
IN(K) = IBLNK 
CALL CLOSE (IFIL) 

CALL ASSIGN(IFIL,JNAME,0,*OLD’) 

IRDR « IFIL 
lERR « 0 

900 RETURN 
END 


